/*
 * 版权所有 (C) 2015 知启蒙(ZHIQIM) 保留所有权利。[遇见知启蒙，邂逅框架梦]
 * 
 * https://zhiqim.org/project/zhiqim_framework/zhiqim_httpd.htm
 *
 * Zhiqim Httpd is licensed under Mulan PSL v2.
 * You can use this software according to the terms and conditions of the Mulan PSL v2.
 * You may obtain a copy of Mulan PSL v2 at:
 *          http://license.coscl.org.cn/MulanPSL2
 * THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OF ANY KIND,
 * EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
 * MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
 * See the Mulan PSL v2 for more details.
 */
package org.zhiqim.httpd.context.extend;

import org.zhiqim.httpd.HttpRequest;
import org.zhiqim.httpd.context.core.Action;

import org.zhiqim.kernel.util.Validates;

/**
 * 提供通过GET和POST请求分开处理，常用于FORM提交
 *
 * @version v1.0.0 @author zouzhigang 2014-3-21 新建与整理
 */
public abstract class GetPostAction implements Action
{
    /** 设置为final，防止子类重写 */
    public final void execute(HttpRequest request) throws Exception
    {
        if (request.isMethodGet())
        {
            //设置浏览器私有缓存表单信息，保证回退时填充表单
            request.setResponsePrivateCache();
            request.setAlertMsg(null);

            //写入验证信息
            validate(request);
            
            //调用子类实现的doGet方式
            doGet(request);
            
            //优先view
            if (!Validates.isEmptyBlank(request.getView()))
                request.setView(request.getView(), request.getInclude());
        }
        else if (request.isMethodPost())
        {
            //先执行validateForm，取得验证
            validate(request);
            
            //判断验证列表，如果有问题直接返回上一页
            if (!request.chkValidate())
            {
                request.returnHistory();
                return ;
            }
            
            //清除验证并处理
            request.clearValidate();
            doPost(request);
            
            //POST优先redirect
            if (!Validates.isEmptyBlank(request.getRedirectInner()))
                request.setRedirectInner(request.getRedirectInner());
        }
    }

    /** 初始化验证列表 */
    protected abstract void validate(HttpRequest request) throws Exception; 
    
    /** doGet方法，由子类实现 */
    protected abstract void doGet(HttpRequest request) throws Exception;
    
    /** doPost方法，由子类实现 */
    protected abstract void doPost(HttpRequest request) throws Exception;

}
